home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Applications 1999 May / SGI IRIX 6.5 Applications 1999 May.iso / dist / arraysvcs.idb / usr / share / catman / p_man / cat3x / assetserveropt.z.z / assetserveropt.z / assetserveropt
Text File  |  1998-10-27  |  9KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((3333xxxx))))                                          aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      assetserveropt, asgetserveropt, asdfltserveropt - set/retrieve server
  10.      options
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaarrrrrrrraaaayyyyssssvvvvccccssss....hhhh>>>>
  14.  
  15.      iiiinnnntttt aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, iiiinnnntttt OOOOppppttttNNNNaaaammmmeeee,,,,
  16.                         ccccoooonnnnsssstttt vvvvooooiiiidddd ****OOOOppppttttVVVVaaaallll,,,, iiiinnnntttt OOOOppppttttLLLLeeeennnn))));;;;
  17.  
  18.      iiiinnnntttt aaaassssggggeeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((aaaasssssssseeeerrrrvvvveeeerrrr____tttt SSSSeeeerrrrvvvveeeerrrr,,,, iiiinnnntttt OOOOppppttttNNNNaaaammmmeeee,,,,
  19.                         vvvvooooiiiidddd ****OOOOppppttttVVVVaaaallll,,,, iiiinnnntttt OOOOppppttttLLLLeeeennnn))));;;;
  20.  
  21.      iiiinnnntttt aaaassssddddffffllllttttsssseeeerrrrvvvveeeerrrroooopppptttt((((iiiinnnntttt OOOOppppttttNNNNaaaammmmeeee,,,, vvvvooooiiiidddd ****OOOOppppttttVVVVaaaallll,,,, iiiinnnntttt OOOOppppttttLLLLeeeennnn))));;;;
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      aaaassssggggeeeettttsssseeeerrrrvvvveeeerrrroooopppptttt and aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt are used to manipulate options
  25.      associated with the server token _S_e_r_v_e_r.  aaaassssddddffffllllttttsssseeeerrrrvvvveeeerrrroooopppptttt is used to
  26.      retrieve the standard default value for those options when a new server
  27.      token is created using aaaassssooooppppeeeennnnsssseeeerrrrvvvveeeerrrr(3X).  The particular option to be
  28.      manipulated is specified by _O_p_t_N_a_m_e, which may be one of the following
  29.      values (defined in <arraysvcs.h>):
  30.  
  31.      _AAAA_SSSS______SSSS_OOOO______TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT
  32.             Sets or retrieves the timeout value (in seconds) for a response to
  33.             a request made to the array services daemon associated with the
  34.             server token.  The timeout value is of type "int".
  35.  
  36.      _AAAA_SSSS______SSSS_OOOO______CCCC_TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT
  37.             Sets or retrieves the timeout value (in seconds) for establishing
  38.             an initial connection with the array services daemon associated
  39.             with the server token.  The timeout value is of type "int".
  40.  
  41.      _AAAA_SSSS______SSSS_OOOO______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD
  42.             Sets or retrieves the state of the forwarding flag associated with
  43.             the server token.  If the flag is non-zero, then any requests made
  44.             with the token will be forwarded to the server associated with the
  45.             token via the array services daemon at the default port on the
  46.             local machine.  If the flag is zero, requests are sent directly to
  47.             the server associated with the token.  The default setting of this
  48.             flag is 0 unless the environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD had a
  49.             value beginning with the letter "Y" (as in "yes", in either upper
  50.             or lower case) at the time the token was created.  The value of
  51.             the flag is of type "int".
  52.  
  53.      _AAAA_SSSS______SSSS_OOOO______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY
  54.             Sets or retrieves the authentication key that is used for any
  55.             messages sent to the array services daemon associated with the
  56.             server token.  The default value of this key is obtained from the
  57.             environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY if it exists, or otherwise is
  58.             set to 0.  The key is of type aaaasssskkkkeeeeyyyy____tttt.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((3333xxxx))))                                          aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt((((3333xxxx))))
  71.  
  72.  
  73.  
  74.      _AAAA_SSSS______SSSS_OOOO______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY
  75.             Sets or retrieves the authentication key that is used for any
  76.             messages received from the array services daemon associated with
  77.             the server token.  The default value of this key is obtained from
  78.             the environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY if it exists, or
  79.             otherwise is set to 0.  The key is of type aaaasssskkkkeeeeyyyy____tttt.
  80.  
  81.      _AAAA_SSSS______SSSS_OOOO______PPPP_OOOO_RRRR_TTTT_NNNN_UUUU_MMMM
  82.             (Only valid with aaaassssddddffffllllttttsssseeeerrrrvvvveeeerrrroooopppptttt).  Retrieves the port number of
  83.             the default array services daemon.  This value is obtained from
  84.             the environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______PPPP_OOOO_RRRR_TTTT if it exists, otherwise the
  85.             port number associated with the service "sgi-arrayd" is used.
  86.  
  87.      _AAAA_SSSS______SSSS_OOOO______HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE
  88.             (Only valid with aaaassssddddffffllllttttsssseeeerrrrvvvveeeerrrroooopppptttt).  Retrieves the hostname of the
  89.             default array services daemon.  This value is obtained from the
  90.             environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD if it exists, otherwise "localhost" is
  91.             used.
  92.  
  93.  
  94.      The parameters _O_p_t_V_a_l and _O_p_t_L_e_n are used to access option values for
  95.      aaaasssssssseeeettttsssseeeerrrrvvvveeeerrrroooopppptttt.  For aaaassssggggeeeettttsssseeeerrrrvvvveeeerrrroooopppptttt and aaaassssddddffffllllttttsssseeeerrrrvvvveeeerrrroooopppptttt, they identify a
  96.      buffer in which the value for the requested option is to be returned.
  97.      For those functions, _O_p_t_L_e_n is a value-result parameter, initially
  98.      containing the size in bytes of the buffer pointed to by _O_p_t_V_a_l, and
  99.      modified on return to indicate the actual size of the value returned.
  100.  
  101.      If any of these functions is unsuccessful, -1 is returned and
  102.      _a_s_e_r_r_o_r_c_o_d_e(3X) will be set appropriately.
  103.  
  104. NNNNOOOOTTTTEEEESSSS
  105.      These functions are found in the library "libarray.so", and will be
  106.      loaded if the option "-larray" is used with _c_c(1) or _l_d(1).
  107.  
  108. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  109.      ascloseserver(3X), aserrorcode(3X), asopenserver(3X), array_services(5).
  110.  
  111. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  112.      Both functions return 0 if successful, -1 if not.  If unsuccessful,
  113.      _a_s_e_r_r_o_r_c_o_d_e(3X) will be set appropriately.
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.